home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / FlipIt / FlipIt.doc < prev    next >
Text File  |  1996-09-26  |  7KB  |  184 lines
  1. ------------------------------------------------------------------------
  2.                                 FlipIt v2.1
  3. ------------------------------------------------------------------------
  4.  
  5.                      FlipIt and this documentation are
  6.                 Copyright © 1994-95 by Michael Barsoom M.D.
  7.  
  8. ------------------------------------------------------------------------
  9.                                   License
  10. ------------------------------------------------------------------------
  11.  
  12. FlipIt may be freely distributed as long as no charge is made other than to
  13. cover time and copying costs.  If it is to be distributed via floppy disk,
  14. this cost should be no higher than $3.00 (three) dollars US.  If distribution
  15. is via CDRom, the total cost should be no more than $25.00 (twenty-five)
  16. dollars US.
  17.  
  18. You may not copy and/or distribute this program without the accompanying
  19. documentation unless you get permission from the author to do so.  Fred Fish
  20. and AmiNet already have my permission to include this program on their
  21. CDRom collections.
  22.  
  23. You may not disassemble, decompile, re-source or otherwise reverse engineer
  24. the program.  If you wish to incorporate parts of this program into other
  25. programs, write to the author to ask for permission.
  26.  
  27. Finally if you wish to include FlipIt on a disk magazine you are REQUIRED
  28. to get the author's permission FIRST.  Usually this will require you to
  29. just send me a copy of the issue which contains FlipIt free of charge
  30. within 2 (two) weeks of the issue's publication.
  31.  
  32. I reserve the right to publically poke fun at anyone who fails to abide by
  33. these distribution rules, along with more severe action if appropriate.
  34.  
  35.  
  36. ------------------------------------------------------------------------
  37.                                 Disclaimer
  38. ------------------------------------------------------------------------
  39.  
  40. This product is sold "as is" without representation or warranty of any
  41. kind, either expressed or implied.  The user assumes all risks and
  42. responsibilities related to its use.
  43.  
  44. ------------------------------------------------------------------------
  45.                                Introduction
  46. ------------------------------------------------------------------------
  47.  
  48. FlipIt lets you install hotkeys for flipping through screens.  You can
  49. specify a hotkey to push the frontmost screen to the back, and a hotkey to
  50. bring the rearmost screen to the front.
  51.  
  52. ------------------------------------------------------------------------
  53.                                Requirements
  54. ------------------------------------------------------------------------
  55.  
  56. There is only one requirement you MUST be using at least Workbench 2.0.
  57.  
  58. Optional:  gtlayout library version 9 or latter (Copyright © by Olaf
  59. `Olsen' Barthel).  Please note that FlipIt is completely functional without
  60. this library, however if you have it installed you can use the popup
  61. interface.  The library will only be opened when you request the window to
  62. appear, and will be closed immediately after the window is closed
  63.  
  64. ------------------------------------------------------------------------
  65.                                    Usage
  66. ------------------------------------------------------------------------
  67.  
  68. Either put it in WBStartup or put it in your user-startup.  If placed in
  69. your user-startup make sure you 'Run' it as FlipIt does not detache from
  70. the cli.
  71.  
  72. FlipIt understands the following ToolTypes/cli arguments.
  73. BACKTOFRONT=<hotkey>  hoykey to bring the back screen to the front
  74.                       default is 'rawkey rcommand down'
  75. FRONTTOBACK=<hotkey>  hoykey to push the front screen to the back
  76.                       default is 'rawkey rcommand up'
  77.  
  78. And the following standard commodities arguments.
  79. Please see your WorkBench manuals for explaination.
  80. CX_PRIORITY=
  81. CX_POPUP=
  82. CX_POPKEY=        default is 'rawkey control lcommand f'
  83.  
  84. To quit FlipIt, send it a kill message from the Cx Exchange, or send it a
  85. ctrl-c with a TaskX like program.
  86.  
  87. ------------------------------------------------------------------------
  88.                            Commodities interface
  89. ------------------------------------------------------------------------
  90.  
  91. The following is available only if you have gtlayout installed.
  92. To see the interface press the popup hotkey, select show interface from the
  93. exchange, or run FlipIt again.
  94.  
  95. The interface is divided into three sections
  96. 1) Configure the screen flipping hotkeys
  97.     Here you specify the hotkey for flipping through the screens.  If you
  98.     type and invalid hotkey sequence, the last hotkey will reappear.
  99.  
  100. 2) Configure the commodity
  101.     Here you can change the standard commodity options
  102.  
  103. 3) Action keys
  104.     Use        - this will close the window and change all the options to
  105.               those specifed above.
  106.     Save    - this will save the options in the icon
  107.     Quit    - quit FlipIt all together
  108.  
  109.     Close gadget - this will close the window and cancel all changes made
  110.  
  111. ------------------------------------------------------------------------
  112.                     Bugs, Suggestions, Donations, Gifts
  113. ------------------------------------------------------------------------
  114.  
  115. you can reach me at:
  116.  
  117. Michael Barsoom
  118. 40 Scott Drive
  119. Bloomfield, CT 06002
  120. USA
  121.  
  122. Internet:  mbars@bluejay.creighton.edu
  123.  
  124. ------------------------------------------------------------------------
  125.                                   History
  126. ------------------------------------------------------------------------
  127.  
  128. -----------------------------------------------------------
  129. Version 2.1                             (25.06.95 22:58:55)
  130. -----------------------------------------------------------
  131.  
  132.      - "Save" will now add DONOTWAIT to the icon's tooltypes.
  133.  
  134.      - When optimizing the code a small bug was found which caused
  135.        CX_POPUP to not be saved to the icon. (fixed)
  136.  
  137.      - Fixed a few small bugs, reported by Serge Leroy
  138.  
  139.  
  140. -----------------------------------------------------------
  141. Version 2.0                             (16.03.95 23:26:13)
  142. -----------------------------------------------------------
  143.  
  144.      - Added popup window to configure hotkeys
  145.        now requires gtlayout.library
  146.  
  147.  
  148. -----------------------------------------------------------
  149. Version 1.3                             (12.03.95 19:37:16)
  150. -----------------------------------------------------------
  151.  
  152.      - ReWrite, removed startup code, optimized, made smaller
  153.  
  154.  
  155. -----------------------------------------------------------
  156. Version 1.2                             (05.06.94 13:35:34)
  157. -----------------------------------------------------------
  158.  
  159.      - Try to stop hang which occurs when screen opens
  160.  
  161.  
  162. -----------------------------------------------------------
  163. Version 1.1                             (01.05.94 10:12:52)
  164. -----------------------------------------------------------
  165.  
  166.      - If run from a shell FlipIt will be the task name.
  167.  
  168.      - Reduced stack usage.
  169.  
  170.  
  171. -----------------------------------------------------------
  172. Version 1.0                             (05.02.94 08:44:53)
  173. -----------------------------------------------------------
  174.  
  175.      - Now will only DisplayBeep() the front most screen when rerun.
  176.  
  177.      - Forgot to put $VER: in version string.
  178.  
  179.      - Added DisplayBeep() to notify user if FlipIt is rerun.
  180.  
  181.        --- Initial release ---
  182.  
  183.  
  184.